概述
- Markdown 的目标是实现「易读易写」。
- Markdown 语法的目标是:成为一种适用于网络的书写语言。(可以兼容HTML)
- HTML 是一种发布的格式,Markdown 是一种书写的格式。
1. 可以兼容HTML
原生markdowm用法
|学号|姓名|分数|
|—|—-|—|
|小明|男|75|
|小红|女|79|
|小陆|男|92|产品|价格
—|—:
Leanote 高级账号|60元/年
Leanote 超级账号|120元/年
兼容HTML用法
斜体 yyy
我是H4标签
加粗 加粗
加粗斜体 加粗
删除线
删除线无序列表
- 无序列表1
- 无序列表2
- 无序列表3
有序列表
- 有序列表1
- 有序列表2
- 有序列表3
- 表格
food
price
apple
$88
2. 特殊字符自动转换
在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是 < 和 &。
& 字符尤其让网络文档编写者受折磨,如果你要打「AT&T」 ,你必须要写成「AT&T」。而网址中的 & 字符也要转换。比如你要链接到:
http://images.google.com/images?num=30&q=larry+bird
你必须要把网址转换写为:
http://images.google.com/images?num=30&q=larry+bird
才能放到链接标签的 href 属性里。不用说也知道这很容易忽略,
这是 H1
这是 H2
这是 H3
3. 区块引用 Blockquotes
这是区块引用1
这是区块引用2
这是区块引用3这是区块引用4
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
这是很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大很大一块区块引用
如果要在列表项目内放进引用,那 > 就需要缩进:
A list item with a blockquote:
This is a blockquote
inside a list item.
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
一列表项包含一个列表区块:
<代码写在这>
当然,项目列表很可能会不小心产生,像是下面这样的写法:
- What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
1986. What a great season.
但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
ih*hh*
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
Use the printf()
function.
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段:
There is a literal backtick (`) here.
4. 图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title’ 文字。